MackerelAgentをAnsibleでインストールする

監視サービス

#Ansible

#Mackerel

#Amazon EC2

#Amazon Linux

#監視サービス

吉江健斗

2018.07.09

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

こんにちわ、吉江です。
皆様はMackerelをご利用でしょうか？
今週の月曜日に200週連続リリースを達成し、進化が止まらないMackerelですが
今回はMackerelAgentをAnsibleでざっくりインストールしてみます。

用意するもの

EC2インスタンス(AmazonLinux1を使用します)

サクッとやってみる

プレイブックを書きましょう

雑な作りになっている自覚はあります。(申し訳ございません) イメージとして頂ければと。

---
- hosts: all
  become: yes
  environment:
      MACKEREL_APIKEY: '<APIキー>'

  tasks:
      # Mackerel-Agentインストーラーダウンロード
      - name: "Get Mackerel-Agent"
        get_url:
            url: "https://mackerel.io/file/script/amznlinux/setup-all-yum.sh"
            dest: "/tmp/setup-all-yum.sh"

      # Mackerel-Agentインストーラー権限変更
      - name: "Permission Mackerel-Agent"
        file:
            state: file
            path: /tmp/setup-all-yum.sh
            group: root
            owner: root
            mode: 0755

      # Mackerel-Agentインストーラー実行
      - name: "Install Mackerel-Agent"
        command: "/tmp/setup-all-yum.sh"

      # Mackerel-Agentサービス停止
      - name: "Stopped Mackerel-Agent"
        service:
            name: mackerel-agent
            state: stopped

      # Mackerel-AgentホストID削除
      - name: "HostID Delete"
        file:
            path: "/var/lib/mackerel-agent/id"
            state: absent

      # Mackerel-Agent_AutoRetirement有効(AutoScalingで使用される場合)
      - name: "AutoScaling_Action"
        lineinfile:
            state: present
            dest: /etc/sysconfig/mackerel-agent
            regexp: '^#\ AUTO_RETIREMENT=1'
            line: 'AUTO_RETIREMENT=1'

各セクションずつ説明を書いてみます。

APIキーの変数化

MackerelAgentをインストールする際には環境変数にAPIキーを仕込んでおくことで、
セットアップスクリプトが環境変数からAPIキーをmackerelagent.confに書き込んでくれる模様です。

  environment:
      MACKEREL_APIKEY: '<APIキー>'

Mackerel-Agentインストールタスク

ざっくり、mackerelのヘルプページにあるagentインストール方法をAnsibleで置き換えて記載しました。

      # Mackerel-Agentインストーラーダウンロード
      - name: "Get Mackerel-Agent"
        get_url:
            url: "https://mackerel.io/file/script/amznlinux/setup-all-yum.sh"
            dest: "/tmp/setup-all-yum.sh"

      # Mackerel-Agentインストーラー権限変更
      - name: "Permission Mackerel-Agent"
        file:
            state: file
            path: /tmp/setup-all-yum.sh
            group: root
            owner: root
            mode: 0755

      # Mackerel-Agentインストーラー実行
      - name: "Install Mackerel-Agent"
        command: "/tmp/setup-all-yum.sh"

ホストID削除

Mackerel-Agentはプロセス起動タイミングでホストIDを/var/lib/mackerel-agent/idに生成します。
このホストIDごとにWebGUI側で管理が行われることからAMIを作成する際にこのホストIDファイルが存在していると
別インスタンスを起動した際にMackerel-Agentが起動失敗します。

      # Mackerel-Agentサービス停止
      - name: "Stopped Mackerel-Agent"
        service:
            name: mackerel-agent
            state: stopped

      # Mackerel-AgentホストID削除
      - name: "HostID Delete"
        file:
            path: "/var/lib/mackerel-agent/id"
            state: absent

AutoScaling対応

mackerelは一度登録されたインスタンスは手動でリタイアメント(退役)を行う必要があります。
ですが、AWS EC2でAutoScalingによるスケールアウトを行うと、起動されるたびにインスタンスが増えることになり、
スケールインされた後も残り続けます。
この残り続けると最新の監視ホストが不明になることからMackerel-Agentのプロセス終了時に自動退役を行うよう、 AutoRetirementを有効にします。

      # Mackerel-Agent_AutoRetirement有効(AutoScalingで使用される場合)
      - name: "AutoScaling_Action"
        lineinfile:
            state: present
            dest: /etc/sysconfig/mackerel-agent
            regexp: '^#\ AUTO_RETIREMENT=1'
            line: 'AUTO_RETIREMENT=1'